Skip to content

Conversation

tammy-baylis-swi
Copy link
Contributor

@tammy-baylis-swi tammy-baylis-swi commented Aug 29, 2025

Description

Updates the DB-API instrumentor readthedocs with sqlcommenter information. Adds encouragement to use concrete db client framework/ORM instrumentors instead, if they exist (e.g. psycopg2, mysqlclient, etc).

Changes and suggestions here will be the "foundation" for fixing the readthedocs of those concrete instrumentors later in another PR.

Partially fixes #3162

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  1. Virtualenv in Python 3.11
  2. tox -e docs
  3. Check local build in docs/_build/html/instrumentation/dbapi/dbapi.html

Does This PR Require a Core Repo Change?

  • Yes. - Link to PR:
  • No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

  • Followed the style guidelines of this project
  • Changelogs have been updated
  • Unit tests have been added
  • Documentation has been updated

@tammy-baylis-swi tammy-baylis-swi changed the title Update DB-API instrumentor docs Update DB-API instrumentor readthedocs with sqlcommenter guide Aug 29, 2025
@tammy-baylis-swi tammy-baylis-swi moved this to Easy to review / merge / close in @xrmx's Python PR digest Sep 2, 2025
@xrmx xrmx enabled auto-merge (squash) October 10, 2025 13:37
@xrmx xrmx moved this from Easy to review / merge / close to Approved PRs in @xrmx's Python PR digest Oct 10, 2025
@xrmx xrmx merged commit 02fedf3 into open-telemetry:main Oct 10, 2025
638 checks passed
@github-project-automation github-project-automation bot moved this from Approved PRs to Done in @xrmx's Python PR digest Oct 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Improve documentation of instrumentation's sqlcommenter feature

4 participants